March 25, 1978

                               E F I N D
                              ===========


     EFIND is a system command which causes a search for a specified key
within a specified file.  The file is assumed to consist of paragraphs
which have been sorted according to their first lines; the file is also
assumed to be in E format with each page beginning with a new paragraph.
EFIND uses the information in the E directory page to limit the range of
its search.

     The syntax of the EFIND command is:

     EFIND [EXACTLY ]<key string> [[IN ]<filespec>]

where square brackets [] indicate optional elements.  <key string> is
the string of characters to be found beginning some paragraph(s) in the
file specified by <filespec>.  Each paragraph which begins with <key
string> is printed in its entirety.

NOTES:

1) There is currently no default file.  <filespec> must not contain
   spaces or tabs.  The file must be in valid E format.

2) If <key string> begins with "exactly" or contains "in", then it must
   be enclosed in double quotes (") or left and right single quotes
   (` and ').  The characters from the opening quote to the closing
   quote, exclusive, are included in the key which may, thus, contain
   the type of quote not being used.

3) The EXACTLY switch implies that case of letters is significant.  The
   default is that case is ignored.  (The keywords EFIND, EXACTLY, and
   IN may be in either upper or lower case.)  NOTE: No template matching
   of the type provided by FIND is available with EFIND.

4) EFIND always delimits its search by paragraphs.  A paragraph ends
   with a line containing nothing but spaces or tabs, or with a page
   mark.  There is no provision for detecting keys which extend past the
   first line of the paragraph.  The characters ";" and "⊗" should not
   appear within the paragraph key of a paragraph which starts a page
   since E removes these characters from the directory line, perhaps
   invalidating the sorting of the directory page.

5) No special file hacks are provided, since no files for which such
   hacks exist are currently in a format suitable for use with EFIND.


EXAMPLES:	EFIND EXACTLY Gandalf IN WIZARD.LST
		efind exactly Gandalf wizard.lst
		efind gandalf wizard.lst
		efind gan wizard.lst
		efind "gandalf" in wizard.lst
		efind exactly `Gandalf' in wizard.lst
		Efind "in" in in

(The last (rather unlikely) example would find all paragraphs beginning
 with "in", "In", "iN", or "IN" in the file called IN.)